home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.2 Development Libraries / SGI IRIX 6.2 Development Libraries.iso / dist / complib.idb / usr / share / catman / p_man / cat3 / complib / cgttrs.z / cgttrs
Text File  |  1996-03-14  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. CCCCGGGGTTTTTTTTRRRRSSSS((((3333FFFF))))                                                          CCCCGGGGTTTTTTTTRRRRSSSS((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      CGTTRS - solve one of the systems of equations  A * X = B, A**T * X = B,
  10.      or A**H * X = B,
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      SUBROUTINE CGTTRS( TRANS, N, NRHS, DL, D, DU, DU2, IPIV, B, LDB, INFO )
  14.  
  15.          CHARACTER      TRANS
  16.  
  17.          INTEGER        INFO, LDB, N, NRHS
  18.  
  19.          INTEGER        IPIV( * )
  20.  
  21.          COMPLEX        B( LDB, * ), D( * ), DL( * ), DU( * ), DU2( * )
  22.  
  23. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  24.      CGTTRS solves one of the systems of equations
  25.         A * X = B,  A**T * X = B,  or  A**H * X = B, with a tridiagonal matrix
  26.      A using the LU factorization computed by CGTTRF.
  27.  
  28.  
  29. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  30.      TRANS   (input) CHARACTER
  31.              Specifies the form of the system of equations:
  32.              = 'N':  A * X = B     (No transpose)
  33.              = 'T':  A**T * X = B  (Transpose)
  34.              = 'C':  A**H * X = B  (Conjugate transpose)
  35.  
  36.      N       (input) INTEGER
  37.              The order of the matrix A.  N >= 0.
  38.  
  39.      NRHS    (input) INTEGER
  40.              The number of right hand sides, i.e., the number of columns of
  41.              the matrix B.  NRHS >= 0.
  42.  
  43.      DL      (input) COMPLEX array, dimension (N-1)
  44.              The (n-1) multipliers that define the matrix L from the LU
  45.              factorization of A.
  46.  
  47.      D       (input) COMPLEX array, dimension (N)
  48.              The n diagonal elements of the upper triangular matrix U from the
  49.              LU factorization of A.
  50.  
  51.      DU      (input) COMPLEX array, dimension (N-1)
  52.              The (n-1) elements of the first superdiagonal of U.
  53.  
  54.      DU2     (input) COMPLEX array, dimension (N-2)
  55.              The (n-2) elements of the second superdiagonal of U.
  56.  
  57.      IPIV    (input) INTEGER array, dimension (N)
  58.              The pivot indices; for 1 <= i <= n, row i of the matrix was
  59.              interchanged with row IPIV(i).  IPIV(i) will always be either i
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CCCCGGGGTTTTTTTTRRRRSSSS((((3333FFFF))))                                                          CCCCGGGGTTTTTTTTRRRRSSSS((((3333FFFF))))
  71.  
  72.  
  73.  
  74.              or i+1; IPIV(i) = i indicates a row interchange was not required.
  75.  
  76.      B       (input/output) COMPLEX array, dimension (LDB,NRHS)
  77.              On entry, the right hand side matrix B.  On exit, B is
  78.              overwritten by the solution matrix X.
  79.  
  80.      LDB     (input) INTEGER
  81.              The leading dimension of the array B.  LDB >= max(1,N).
  82.  
  83.      INFO    (output) INTEGER
  84.              = 0:  successful exit
  85.              < 0:  if INFO = -i, the i-th argument had an illegal value
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.